ServerStat and ServerStat Lite are identical in their reporting capabilities. There are two types of reports available in ServerStat.. The HTML reports can include any valid html tags. The Text reports are designed to contain only ASCII text suitable for display on a Gopher server, but can contain any characters available on your Macintosh like en-dashes or em-dashes. You can take your pick as to which report type ServerStat will create.
To customize a report, you can modify the HTML coding in the HTML Format window within ServerStat. The HTML and Text formats are saved with the settings file so you can have multiple report formats using multiple settings files. When you want to add a section of statistics you let ServerStat know by including a report format key word on a line by itself and enclosed in [ ]’s. The first character on a keyword line should be a left bracket ‘[’ character followed immediately by the keyword and a closing right bracket ‘]’. The keywords are not case sensitive so [SUMMARY] has the same effect as [Summary] or [sUmMaRy].
ServerStat is intelligent enough to know what columns to include in your report. If you are not recording Bytes_Sent in your log, then a byte transmission amount is not displayed in your report. The same goes for Transfer_Time, Hour, Agent, and Method.
The keyword descriptions are listed below.
[SUMMARY]
Will print the files transmitted, unique sites, and average files for GopherSurfer logs. For MacHTTP logs processed with the Log Type: MacHTTP, [SUMMARY] will display the files transmitted, bytes transmitted, unique sites, average files per day, and average bytes per day. For WebStar, this keyword is intelligent enough to look and see what tokens you are scanning for. If all are turned on, it will display everything that a MacHTTP log does as well as the total time the machine spent transferring data down to the 1/100th of a second.
The remaining keywords are broken down in to two categories. Stats categories and frequency categories. For GopherSurfer logs, each line in a stats category will display the identifying information followed by the number of files and the percentage of the files sent. For MacHTTP logs, it will report the number of files sent, the percentage of the files sent, the number of bytes sent, and the percentage of the bytes sent. For WebStar, it again looks at the tokens to see what it can display. A full display would result in the number of files sent, the percentage of the files sent, the number of bytes sent, the percentage of bytes sent, and the amount of time transmitting. The Stats keywords are listed now:
[DAY]
Will print a line for each day within the reporting period you specify where transactions have taken place.
[HOUR]
Will divide the day into the 24 hours and report a line for each hour of the day and its activity. If the reporting period is more than one day, each line will represent the sum total for that hour over the reporting period.
[WEEKDAY]
Will list a report line for each day of the week. If the reporting period is more than one week, these lines will represent the sum total for that day of the week over the
reporting period.
[DOMAIN]
If IP addresses are resolved into Domain Names, or you have the servers doing lookups automatically while serving data, this section of a report will look at the DOMAIN commands that have been entered in the Configuration Window for the lines to report. So, you can get a single line total for all of the ".edu" addresses that have connected to your server.
[SUBDOMAIN]
This section of the report will list each sites activity for your server. For some servers this section of the report can become very long. If you use the SUBLEVELS command in ServerStat (commercial version only), you can tell ServerStat how many levels of a domain name to include in this section of a report.
[ARCHIVE]
This section of a report will list each file that has been accessed and detail its activity. You can use the FILTER command to limit the files that will display in this report section.
[USER]
The User token is entered mainly for authenticated systems. If you have an authenticated system, this report keyword will list each user and their activity.
[FROM]
Will typically contain the e-mail address of an authenticated user. You can get a listing by this field as well.
The Frequency keywords are listed below. Their function is just to report the number of accesses based on the unique items in the log.
[METHOD]
For those who are interested in the HTTP commands sent to their server, this section will identify each unique command sent to your server and how many times it was sent.
[AGENT]
Many of the newer browsers identify themselves to the server. So, if you are interested in how many Netscape clients connect versus Mosaic, MacWeb, etc. this command will identify each unique client listed in the log and report the frequency of files they accessed.
[REFERER]
WebStar allows you to record where users came to your site from. This section of the report is helpful in identifying what servers are pointing to yours.
